home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / zoo120.arc / UPD110.DOC next >
Encoding:
Text File  |  1986-08-24  |  11.0 KB  |  301 lines
  1.                                     Zoo
  2.  
  3.                             A Fast File Archiver
  4.                Version 1.10 - 24 August 1986
  5.  
  6.                                      by
  7.  
  8.                                 Rahul  Dhesi
  9.  
  10.  
  11.                                 UPDATE NOTES
  12.  
  13.  
  14. This is an update to the Zoo user manual.  If you have a user manual for any
  15. earlier version of Zoo, this update contains all information needed to allow
  16. you to use Zoo 1.10.
  17.  
  18.  
  19.                               COMMAND SUMMARY
  20.  
  21. Zoo has two types of commands:  Expert commands, which consist of one com-
  22. mand letter followed by zero or more modifier characters, and Novice com-
  23. mands, which consist of a hyphen ("-") followed by a command word that may
  24. be abbreviated.  Novice commands let you begin using Zoo quickly.  Unlike
  25. Expert commands, which are case-sensitive, Novice commands can be given in
  26. any combination of upper- and lowercase characters.
  27.  
  28. Expert commands are cryptic but offer you many more flexible options.  Start
  29. with the Novice commands and switch to using the Expert commands as soon as
  30. you can.
  31.  
  32.  
  33. 1.   Zoo Novice Command Format:
  34.  
  35.      ZOO cmd archive[.ZOO] [file] ...
  36.  
  37. Each Novice command works in two stages.  First, the command does its inten-
  38. ded work.  Then, if the result was that one or more files were deleted in
  39. the specified archive, the archive is packed to recover space.
  40.  
  41. Novice                                                     Equivalent
  42. Command       Description                                  Expert Command
  43. -------       -----------                                  --------------
  44. -add          add files to archive                           aP
  45. -extract      extract files from archive                     x
  46. -move         move files to archive                          aMP
  47. -test         test archive integrity                         xNd
  48. -print        extract files and send to standard output      xp
  49. -delete       delete files from archive                      DP
  50. -list         list information about archived files          l
  51. -update       update archive by adding new or newer files    aunP
  52. -freshen      freshen archive by adding newer files          auP
  53. -comment      allows user to attach comments to files        c
  54.  
  55. Novice commands may be abbreviated as much as you wish, up to a minimum of a
  56. hyphen ("-") followed by at least one command character.  For example, the
  57. novice command "-extract" may be abbreviated to "-ext", "-ex", or "-e".
  58. Novice commands are described in more detail later.
  59.  
  60.  
  61. 2.   Zoo Expert Command Format:
  62.  
  63.      ZOO {acDehlPTuUvx}[cdEfnMNoOpPquv1] archive[.ZOO] [file] ...
  64.  
  65. Invoking Zoo as "zoo h" will give a help screen.  Zoo Expert commands are
  66. described in detail later.
  67.  
  68.  
  69.                               NOVICE COMMANDS
  70.  
  71.  
  72. 1.   Adding Files to an Archive
  73.  
  74. Format:  ZOO -add archive[.ZOO] file ...
  75.  
  76.      The specified files are added to the archive.  If all specified files
  77.      were added without any error, and if this resulted in deletion of a
  78.      file that was already in the archive, the archive is packed.
  79.  
  80.  
  81. 2.   Extracting Files from an Archive
  82.  
  83. Format:  ZOO -extract archive[.ZOO] [file] ...
  84.  
  85.      The specified files are extracted from the archive.  If no file was
  86.      specified, all files are extracted from the archive.  All extracted
  87.      files go into the current directory.
  88.  
  89.  
  90. 3.   Moving Files to an Archive
  91.  
  92. Format:  ZOO -move archive[.ZOO] file ...
  93.  
  94.      -Move works just like -add, except that after all files have been
  95.      added, if no error occurred, the added files are deleted from disk.
  96.  
  97.  
  98. 4.   Testing an Archive
  99.  
  100. Format:  ZOO -test archive[.ZOO]
  101.  
  102.      This is equivalent to the -extract command, except that extracted files
  103.      are not saved.  If no CRC error or other error occurs during execution
  104.      of the -test command, this indicates with a high degree of confidence
  105.      that the archive is not corrupted.
  106.  
  107.  
  108. 5.   Printing Files from an Archive
  109.  
  110. Format:  ZOO -print archive[.ZOO] [file] ...
  111.  
  112.      This option extracts specified files from the archive and sends the
  113.      extracted data to standard output, which is normally the screen.
  114.  
  115.  
  116. 6.   Deleting Files in an Archive
  117.  
  118. Format:  ZOO -delete archive[.ZOO] file ...
  119.  
  120.      The specified files are deleted from the archive, and then the archive
  121.      is packed to recover space that was occupied by the deleted files.
  122.  
  123.  
  124. 7.   Listing Files in an Archive
  125.  
  126. Format:  ZOO -list archive[.ZOO] [file] ...
  127.  
  128.      This gives a list of the specified files along with information about
  129.      each file's original size, size as stored in the archive, compression
  130.      factor, and date.
  131.  
  132.  
  133. 8.   Updating an Archive
  134.  
  135. Format:  ZOO -update archive[.ZOO] file ...
  136.  
  137.      This command is like -add, except that if a file being added is already
  138.      in the archive, it is added only if the copy being added is newer than
  139.      the copy already in the archive.  The -update command adds all the
  140.      files that the -freshen command would add (below) and also adds any
  141.      files that are not already in the archive.
  142.  
  143.  
  144. 9.   Freshening an Archive
  145.  
  146. Format:  ZOO -freshen archive[.ZOO] file ...
  147.  
  148.      This command is like -add, except that a file is added only if it is
  149.      already in the archive, AND if the copy being added is newer than the
  150.      copy already in the archive.
  151.  
  152.      The -freshen command simply brings archived files up to date without
  153.      adding any files that weren't already in the archive.
  154.  
  155.  
  156. 10.  Adding comments to an Archive
  157.  
  158. Format:  ZOO -comment archive[.ZOO] file ...
  159.  
  160.      Zoo allows each archived file to have an optional attached comment.
  161.      Any comment attached to a file is listed when the Novice -list command
  162.      is given.  The -comment command allows comments to be attached,
  163.      removed, and updated.
  164.  
  165.      When invoked with the -comment command, Zoo goes through the specified
  166.      archive and for each matching file, shows you the comment (if any) and
  167.      allows you to type a replacement comment.  Your choices are:
  168.  
  169.      o    Type a carriage return alone to leave unchanged any attached
  170.           comment.
  171.      o    Type "/END" and carriage return to remove any comment attached to
  172.           the file.
  173.      o    Type a comment of up to 65,535 characters long.  Terminate it by
  174.           typing "/END" by itself on the last line.  The new comment will
  175.           replace any previous comment.
  176.  
  177.      For better formatting in listings, keep each line of the comment to 77
  178.      characters or less.  Since comments are not compressed, they should not
  179.      be excessively long.
  180.  
  181.      It is possible to create a file of comments with a text editor and give
  182.      it to Zoo as input using DOS's input redirection character "<".  In
  183.      this case, the comments in the file must be in exact sequence.  If this
  184.      input file has fewer comments than Zoo expects, comments for remaining
  185.      matching files will be left unchanged.
  186.  
  187.      If end-of-file is reached before all comments have been accounted for,
  188.      Zoo simply leaves all remaining files' comments unchanged.  End-of-file
  189.      can be caused by the user typing a control Z interactively or the
  190.      redirected input being smaller than Zoo expects.
  191.  
  192.      Examples:  "zoo -comment batch *.bat" shows any comment that may be
  193.      attached to each *.bat file in the archive "batch.zoo" and allows you
  194.      to type a new comment.  Type as many lines as you wish, then type
  195.      "/END" by itself on a line to terminate the comment.  If, however, you
  196.      want to leave the original comment unchanged, just hit return.  You may
  197.      type control Z at any point to leave all remaining files' comments
  198.      unchanged.
  199.  
  200.      "zoo -comment qmodem *.doc *.00? <qcomment.txt" makes Zoo read new
  201.      comments from the file "qcomment.txt".  For each file matching *.doc
  202.      and *.00?, Zoo reads data from qcomment.txt and reacts exactly as with
  203.      interactive input:  an empty line (carriage return alone) in
  204.      "qcomment.txt" leaves the original comment unchanged;  "/END" by itself
  205.      removes the original comment;  any other text terminated by "/END" on a
  206.      separate line replaces a comment.  If "qcomment.txt" ends prematurely,
  207.      all remaining files have their comments left unchanged.
  208.  
  209.  
  210.  
  211.                               EXPERT COMMANDS
  212.  
  213. 1.   Adding Files to an Archive
  214.  
  215. Format:  ZOO {au}[cfMnPqu] archive[.ZOO] file ...
  216.  
  217. New Modifier:
  218.  
  219.      c    Add comments when adding files.  Equivalent to the Novice -comment
  220.           command.
  221.  
  222.           Note:  Since comments for replaced files become automatically
  223.           attached to corresponding newly-added files, the freshening of an
  224.           archive with the Novice -freshen command or the Expert au command
  225.           does not cause loss of comments.
  226.  
  227. Also note that the u modifier adds a file to an archive only if the copy
  228. being added is newer than the already-archived copy.
  229.  
  230. All combinations of the [cfMnPqu] modifiers are valid.  The combination of n
  231. and u together adds a file to the archive either if the file is not already
  232. in the archive, OR if the file is already in the archive but the archived
  233. copy is older than the copy being added.
  234.  
  235.  
  236. 2.   Extracting Files from an Archive
  237.  
  238. Format: ZOO {ex}[dNoOpq] archive[.ZOO] [file] ...
  239.  
  240.  
  241. 3.   Listing Files in an Archive
  242.  
  243. Format:  ZOO {lv}[dfv] archive[.ZOO] [file] ...
  244.  
  245. Changed Command Character:
  246.  
  247.      v    Verbose list.  Equivalent to l but also shows any comment attached
  248.           to each file.  Currently, the v command shows the entire comment
  249.           attached to each file.  Version 2.00 of Zoo is expected to allow
  250.           the user to specify that only the first n lines of each comment be
  251.           shown.
  252.  
  253. If f and v modifiers are used together, f overrrides v.
  254.  
  255.  
  256. 3.   Deleting Files in an Archive
  257.  
  258. Format:  ZOO D[Pq1] archive[.ZOO] file ...
  259.  
  260.           See any earlier manual for details.
  261.  
  262.  
  263. 4.   Undeleting Files in an Archive
  264.  
  265. Format:  ZOO U[q1] archive[.ZOO] file ...
  266.  
  267.           See any earlier manual for details.
  268.  
  269.  
  270. 5.   Adjusting the Timestamp of an Archive
  271.  
  272. Format:  ZOO T[q] archive[.ZOO]
  273.  
  274.           See any earlier manual for details.
  275.  
  276.  
  277. 6.   Packing an Archive
  278.  
  279. Format:  ZOO P[EPq] archive[.ZOO]
  280.  
  281.           See any earlier manual for details.  Also note that the original
  282.           archive is renamed to an extension of ".bak" regardless of which
  283.           disk/directory it is on.
  284.  
  285.  
  286.                 CONVERSION FROM OTHER FORMATS TO ZOO FORMAT
  287.  
  288. Note that due to differences between the batch languages of DOS 3.x and DOS
  289. 2.x, Atoz 1.00 works only with DOS 2.x.
  290.  
  291.  
  292.                            VERSION COMPATIBILITY
  293.  
  294. Zoo 1.10 can add information to an archive in the form of attached comments
  295. that earlier versions of Zoo cannot interpret.  Earlier versions of Zoo will
  296. list and extract files from version 1.10 archives and delete and undelete
  297. files in them.  But to avoid any loss of information, earlier versions of
  298. Zoo will refuse to modify version 1.10 archives in any other way.  Instead,
  299. the following message will be given:  "Version 1.10 of Zoo is needed to
  300. fully manipulate this archive."
  301.